============================================================
FIL-TALK MEDIA DOWNLOADER v1.000
User Guide
============================================================

WHAT IS FIL-TALK MEDIA DOWNLOADER?

Fil-Talk Media Downloader is a Windows application for
downloading videos and audio from the internet. It is designed
to be fully accessible to keyboard users and screen reader
users, including users who are blind or visually impaired.

This application is intended for media that you are legally
allowed to download.

============================================================
QUICK START
============================================================

1. Double-click Fil-Talk-Media-Downloader.exe to launch.
2. Type or paste a URL in the Media URL field.
3. Select your preferred options (format, quality, etc.).
4. Press Tab to the Download button and press Enter.
5. The download will appear in the Download Queue.

============================================================
KEYBOARD NAVIGATION
============================================================

Tab            Move to the next control
Shift+Tab      Move to the previous control
Enter/Space    Activate the focused button
Arrow Keys     Navigate dropdown lists
Escape         Close dialogs
Ctrl+D         Start download
F1             Open Help
Delete         Remove selected queue item

============================================================
DOWNLOAD MODES
============================================================

Single Media:
  Download a single video or audio file.

Playlist:
  Download multiple items from a playlist.
  The application will detect playlists automatically.

============================================================
FORMATS
============================================================

Audio: MP3, WAV, FLAC, AAC, M4A, OPUS, OGG
Video: MP4, MKV, WebM, MOV

Not all formats are available for every download.

============================================================
QUALITY
============================================================

Audio: Best Available, 320 kbps, 256 kbps, 192 kbps,
       128 kbps, Source/Original

Video: Best Available, 2160p, 1440p, 1080p, 720p,
       480p, 360p

If the requested quality is unavailable, the closest
available quality will be used.

============================================================
OUTPUT FOLDER
============================================================

By default, files are saved to the "media" folder inside the program's
own folder (the portable folder).  It is created automatically, and it
moves with the program if you copy the folder to another drive or a USB
stick.

Click Browse to select a different folder.

You can set a permanent default in Settings.

============================================================
UPDATES
============================================================

The program updates itself from filtalk.org.  When it starts it checks
quietly for a new version (turn this off in Settings, General); use
Help > Check for Updates to check at any time.  When a new version is
found you are told what is new and asked whether to install it.  The
update downloads, is checked for damage, and the program closes,
replaces its files and opens again.  Your settings, history and the
media folder are never touched by an update.

============================================================
DOWNLOAD QUEUE
============================================================

The Download Queue shows all queued downloads.

Each item displays:
- Title
- Status (Queued, Downloading, Completed, Failed)
- Progress

Queue actions:
- Move Up / Move Down: Reorder items.
- Remove: Remove an item.
- Clear Completed: Remove finished items.
- Open Folder: Open the output folder.
- Copy URL: Copy the item's URL.

============================================================
CONTEXT MENU (APPLICATION KEY)
============================================================

Select a queue item and press the Application key
(or right-click) to access:
- Pause / Resume
- Cancel
- Retry
- Remove
- Open Output Folder
- Copy URL
- View Error

============================================================
SETTINGS
============================================================

Click Settings to configure:
- Default output folder
- Duplicate file behavior
- Concurrent downloads
- Retry count
- Default audio format and quality
- Default video format and quality
- Screen reader options

============================================================
HELP
============================================================

Press F1 or click Help for the complete user manual.

The help system is built into the application and is
fully accessible to screen readers.

============================================================
FFmpeg / FFPROBE REQUIREMENT
============================================================

FFmpeg and FFprobe are required for:
- Converting downloads to MP3, WAV, FLAC, AAC, M4A,
  OPUS, OGG, or other audio formats.
- Converting between video formats.
- Reading media file information.
- Editing audio metadata.
- Audio normalization.

BUNDLED VERSION:
  The packaged application includes ffmpeg.exe and
  ffprobe.exe in the same folder as the application.
  No additional installation is required.

If FFmpeg is not found, the application will show a
warning at startup and conversion features will not
work. Downloads in the original format may still work.

FFmpeg is provided under LGPL/GPL license.
See LICENSE.txt for details.

============================================================
SUPPORTED SITES
============================================================

Fil-Talk Media Downloader uses yt-dlp, which supports
many websites including YouTube, Vimeo, Dailymotion,
SoundCloud, Twitch, and many more.

Not all websites are supported. If a site is not
supported, the application will display an error message.

============================================================
WINDOWS SECURITY NOTE
============================================================

This application is currently a development build and is
NOT digitally signed. Windows may display a security
warning (SmartScreen or Smart App Control) when you
first run the application.

This is normal behavior for unsigned applications.

To run the application:
1. Windows may show a warning dialog.
2. Click "More info" if available.
3. Click "Run anyway".

Production releases will be digitally signed with a
trusted certificate to eliminate these warnings.

DO NOT disable Windows security features to run this
application. The warning appears because the application
is new and unsigned, not because it is harmful.

============================================================
SCREEN READER USE (NVDA)
============================================================

This application is designed for use with NVDA.

- All controls are standard Windows widgets.
- Tab/Shift+Tab to navigate between controls.
- Arrow keys to navigate within lists.
- Status changes are announced.
- The Application key opens context menus.
- All dialog content is accessible text.

============================================================
LIMITATIONS
============================================================

- DRM-protected content cannot be downloaded.
- Download speed depends on your connection.
- Not all quality options are available for every source.
- Some websites may require authentication.
- Website changes may temporarily break support.

============================================================
TROUBLESHOOTING
============================================================

Download fails:
  Check the URL and ensure the site is supported.

Slow downloads:
  Check your internet connection.

Format not available:
  Try "Best Available" quality or a different format.

Conversion fails (MP3, WAV, FLAC, etc.):
  FFmpeg is required for format conversion.
  Ensure ffmpeg.exe is in the application folder.
  Check Settings -> Engines to see FFmpeg status.

FFmpeg not found warning at startup:
  The bundled version includes ffmpeg.exe.
  If missing, download FFmpeg and place it
  next to the application executable.

Application unresponsive:
  Close and restart. Check filtalk.log for details.

Windows security warning:
  This is normal for unsigned applications.
  Click "More info" then "Run anyway".
  Production releases will be properly signed.

============================================================
LICENSE
============================================================

See LICENSE.txt in the application folder.

Includes FFmpeg under LGPL/GPL license.
See LICENSE.txt for full third-party notices.

============================================================
Fil-Talk Media Downloader v1.000
============================================================
